docs: Document the "accessibility" custom tag

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 126712b9c87d070894d42eddcb26d4883a351bc6..8747e8efcdd19b47ab6b06a6bb3b2f54ea77096a 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -248,8 +248,8 @@
  *
  * # GtkWidget as GtkBuildable
  *
- * The GtkWidget implementation of the GtkBuildable interface supports a
- * custom <accelerator> element, which has attributes named ”key”, ”modifiers”
+ * The GtkWidget implementation of the #GtkBuildable interface supports a
+ * custom `<accelerator>` element, which has attributes named ”key”, ”modifiers”
  * and ”signal” and allows to specify accelerators.
  *
  * An example of a UI definition fragment specifying an accelerator:
@@ -260,7 +260,7 @@
  * ]|
  *
  * If the parent widget uses a #GtkLayoutManager, #GtkWidget supports a
- * custom <layout> element, used to define layout properties:
+ * custom `<layout>` element, used to define layout properties:
  *
  * |[
  * <object class="MyGrid" id="grid1">
@@ -288,8 +288,8 @@
  * </object>
  * ]|
  *
- * Finally, GtkWidget allows style information such as style classes to
- * be associated with widgets, using the custom <style> element:
+ * GtkWidget allows style information such as style classes to
+ * be associated with widgets, using the custom `<style>` element:
  * |[
  * <object class="GtkButton" id="button1">
  *   <style>
@@ -299,6 +299,17 @@
  * </object>
  * ]|
  *
+ * GtkWidget allows defining accessibility information, such as properties,
+ * relations, and states, using the custom `<accessibility>` element:
+ * |[
+ * <object class="GtkButton" id="button1">
+ *   <accessibility>
+ *     <property name="label">Download</property>
+ *     <relation name="labelled-by">label1</relation>
+ *   </accessibility>
+ * </object>
+ * ]|
+ *
  * # Building composite widgets from template XML ## {#composite-templates}
  *
  * GtkWidget exposes some facilities to automate the procedure